home *** CD-ROM | disk | FTP | other *** search
/ EnigmA Amiga Run 1997 April / EnigmA AMIGA RUN 17 (1997)(G.R. Edizioni)(IT)[!][issue 1997-04][EAR-CD].iso / EARCD / text / misc / FontView30.lha / Docs / FontView.doc next >
Text File  |  1996-12-16  |  25KB  |  677 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.                                    FontView
  7.  
  8.  
  9.                                    Version
  10.                                      3.0
  11.  
  12.  
  13.  
  14.  
  15.                                  Steve Banham
  16.  
  17.  
  18.  
  19.                      Copyright 1996, All Rights Reserved
  20.  
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32.  
  33.  
  34.  
  35.  
  36.                          Generated with Heddley v1.1
  37.                       Heddley v1.1 (C) Edd Dumbill 1994
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.  
  71.  
  72.  
  73.  
  74.  
  75.  
  76.                                   - Page 1 -
  77.  
  78.  
  79.  
  80. 1.    FontView v3.0 ©1996 Steve Banham
  81.  
  82.  
  83.  
  84.                               FontView v3.0
  85.  
  86.                          - Distribution information.
  87.                          - FontView description.
  88.                          - Installation/requirements.
  89.                          - Running from the Cli.
  90.                          - Running from the Workbench.
  91.                          - How To Use FontView.
  92.                          - Development History.
  93.                          - Program Credits.
  94.                          - Registration Info.
  95.                          - Contacting the Author.
  96.  
  97. 2.    Legal Information
  98.  
  99.  
  100.  
  101.  Legal Information
  102.  
  103.     FontView  is  NOT  Public  Domain,  the main program and all
  104. associated files  remain  copyright  ©1996 Steve Banham.  If you find FontView
  105. useful, and  would  like  to  continue  using  it  then  please read the
  106. section on registration.
  107.  
  108.     The  user  takes  full  responsiblity  for  ANY problem which may
  109. occur through using FontView.  Whilst the program has been extensively tested
  110. and the  author  has  not  found  any  dangerous problems, if anything
  111. untoward happens  through  using  it  then  I,  the  author,  take  NO
  112. reponsibility whatsoever.
  113.  
  114.     Whilst,  I  am  keen to find/eliminate any bugs in FontView and add
  115. new features, my continued interest in updating this program will be
  116. influenced by the  number of registrations received.  In other words, if
  117. people don't do the right thing and send the small amount requested then my
  118. interest in the program will dwindle accordingly.
  119.  
  120.     The  program  may  not  be used in any commercial venture without
  121. prior written consent from the author.  It may be included in PD or
  122. shareware libraries (eg, Aminet, Fred Fish) which charge only a nominal fee
  123. for disk copying.
  124.  
  125.     All files must accompany any distribution of FontView.
  126.  
  127. 3.    What Is FontView?
  128.  
  129.  
  130.  
  131.  What Is It?
  132.  
  133.     This program enables the user to view all aspects of either bitmap or
  134. compugraphic fonts.  The interface displays a sample of the selected font,
  135. which can be modified in real time, allowing different styles to be applied to
  136. it.
  137.  
  138.     In addition to a visual display, the user can open an information window
  139. which contains every detail about the selected font.
  140.  
  141.     The standard FONTS:  directory can be changed so that fonts can be viewed
  142. from anywhere.  [Warning:  This function does not work if you use a font cache
  143. program such as MCP].  Your FONTS:  directory will be reset to the normal
  144. place once you quit the program.
  145.  
  146.  
  147.                                   - Page 2 -
  148. 3.    What Is FontView?
  149.  
  150.     Another feature of FontView is that you can make it jump to different
  151. public screens, allowing you to view fonts under all sorts of different screen
  152. modes.  This makes it much easier to see whether a font will suit your needs
  153. eliminating the need to reconfigure the application you wish to use the font
  154. with.
  155.  
  156. 4.    Installation
  157.  
  158.  
  159.  
  160.  Installation
  161.  
  162.     FontView  requires  Workbench  2.04+ (v37) in order to run.  If you
  163. are running anything lower than this then the program will simply fail to
  164. run.
  165.  
  166.     You   also  need  reqtools.library  v38.1248  correctly  installed
  167. for FontView  to  work.   As long as it is installed, just copy FontView to
  168. the destination  of  your choice.  You must use at least v38.1248 - there
  169. seems to be a bug of some kind with earlier versions of reqtools' font
  170. requester. 
  171.  
  172.     No special assigns are required for FontView to work, although it does
  173. need to access two commands from your system. You need to ensure that the
  174. 'assign' command is in your C: directory, and that FixFonts program is in the
  175. SYS:System/ drawer. This allows FontView to update all the #?.font files in
  176. the FONTS: directory. You can actually place the Fixfonts program anywhere you
  177. like as long as you change the tooltype FIXFONTS to reflect this.
  178.  
  179. 5.    Cli Usage
  180.  
  181.  
  182.  
  183.  Running From Cli/Shell
  184.  
  185.     The following arguments can be supplied to FontView from the Cli.
  186. These are:
  187.  
  188.     PUBSCREEN   : The Name of a Public Screen to open on - defaults to
  189.                   workbench.
  190.  
  191.     FIXFONTS    : The full path (dir and filename) to the fixfonts program
  192.                   which can be launched with FontView to update the font
  193.                   files when you add or delete a fontsize.
  194.  
  195.     eg:
  196.  
  197.         Shell> FontView PUBSCREEN=DOPUS.1 FIXFONTS=RAM:Fixfonts
  198.  
  199.         This will force FontView to startup on the Public Screen called
  200.         DOPUS.1 (DirectoryOpus's default screen name). And to use the
  201.         program 'RAM:Fixfonts' if the user presses the fixfonts gadget.
  202.  
  203. 6.    Workbench Usage
  204.  
  205.  
  206.  Running From Workbench
  207.  
  208.     FontView currently only supports one Tooltype, this is:
  209.  
  210.     PUBSCREEN   =   The screen which FontView will initially open it's
  211.                     window on - defaults to workbench.
  212.  
  213.     FIXFONTS    =   The full path (dir and filename) to the fixfonts
  214.                     program which can be launched with FontView to
  215.                     update the .font files.
  216.  
  217.  
  218.                                   - Page 3 -
  219. 6.    Program Operation
  220.  
  221.  
  222. 7.    Program Operation
  223.  
  224.  
  225.  
  226.  Program Operation
  227.  
  228.     FontView can be run from either  CLI  or  Workbench . Once run, a
  229. window will open containing various gadgets.
  230.  
  231.                Gadgets      - Program gadget descriptions.
  232.                Information  - Font information definitions.
  233.  
  234.     There are four extra gadgets in the main window which allow you to select
  235. the font style which will be displayed in the sample.  As of v3.0 this works
  236. in real-time.  As soon as you select a style, the font sample will be updated
  237. to reflect the changes.  Try them to see what they do.  Be aware that not all
  238. fonts allow all the styles.  You may find that with some fonts although
  239. certain styles have been selected the actual displayed font does not have
  240. these characteristics.  This is perfectly normal and not a bug.
  241.  
  242.     Some functions are duplicated in the pull down menus for convenience.
  243.  
  244.     Change dir      -    does the same thing as the 'Directory Button'.
  245.     Select Font     -    is identical to the 'Select Font Button'.
  246.  
  247.     The  program is reasonably simple, play around and you'll soon
  248. discover how it works.
  249.  
  250. 8.    Gadgets
  251.  
  252.  
  253.  
  254.  Gadgets
  255.  
  256.   Select Font Button -   Brings up a font requester from which you can
  257.                          choose a font and it's size. The font name
  258.                          will be visible in the window.
  259.  
  260.   Directory Button   -   Brings up a directory requester which can be used
  261.                          to select a new path to assign FONTS: too. This
  262.                          allows the font requester to be used to access
  263.                          fonts from anywhere. When the program is ended it
  264.                          resets the FONTS: assign to: 'SYS:Fonts/'.
  265.  
  266.   Font Information   -   Brings up a seperate window which contains all of
  267.                          the selected fonts particulars. This button
  268.                          toggles the information window on and off. If you
  269.                          change screens this window will always start off
  270.                          closed.
  271.  
  272.   Move To New Screen -   Opens a screen requester which contains all the
  273.                          available Public Screens. Select one and then
  274.                          FontView will move to that screen. I have noticed
  275.                          that some screens (CygnusEd) show up as a Public
  276.                          Screen, but you can only move to them if they are
  277.                          configured to allow visitors. CygnusED has a menu
  278.                          option to do this.
  279.  
  280.   Fix Fonts          -   Runs the Fix Fonts program to update the #?.font
  281.                          files. Useful when you remove or add a particular
  282.                          size of font to/from your Hard Drive. The #?.font
  283.                          files will be updated to reflect your changes.
  284.                       ** Remember that this function operates on the FONTS:
  285.                          directory so make sure you set the directory
  286.                          assign to the directory you intend to update.
  287.  
  288.  
  289.                                   - Page 4 -
  290. 8.    Gadgets
  291.  
  292.   Registered Users   -   Brings up a list of FontView's Registered Users
  293.  
  294.   About              -   Information about the program.
  295.  
  296.   Quit               -   Quit program.
  297.  
  298. 9.    Font Information
  299.  
  300.  
  301.  
  302.  Font Information 
  303.  
  304.   Height        :  The height of the font (number of pixels/lines).
  305.  
  306.   Width         :  The nominal width of each character. If the font
  307.                    is normal (non proportional) this is the width
  308.                    between the first pixels of two characters. If a
  309.                    proportional font is used a special array of
  310.                    different width for each character may be used.
  311.  
  312.   Low (Char)    :  A font can consist of up to 256 characters, but
  313.                    usually the font is much smaller. You can for
  314.                    example have a font which only consists of
  315.                    capital letters (A, B, C, .. Y, Z). This field
  316.                    tells us and the system which is the first character.
  317.  
  318.   High (Char)   :  The last character in this font.
  319.  
  320.   B(ase)Line    :  The number of pixels down the baseline is from the
  321.                    top of the characters. You may not use a base line
  322.                    which is greater than the nominal height - 1
  323.                    (tf_YSize-1), or the system may crash!
  324.  
  325.   (Bold)Smear   :  When you change the style to bold by calling the
  326.                    SetSoftStyle() function a copy of the font is
  327.                    placed on top of itself and a bit to the right.
  328.                    The further to the right, the bolder characters.
  329.                    This value represents the number of pixels to the
  330.                    right the characters should be moved. This value
  331.                    is usually set to 1, but large fonts usually need
  332.                    larger values.
  333.  
  334.   Modulo        :  The graphics (character data) for the characters
  335.                    are organized into lines. First comes the top line
  336.                    of all characters, then the second line and so
  337.                    on... This value represents the number of bytes
  338.                    needed for each line.
  339.  
  340.   Tall          :  The font is specially designed for high resolution
  341.                    screens with no interlace. (Each pixel is only half
  342.                    as wide as it is tall.)
  343.  
  344.   Wide          :  The font is specially designed for low resolution
  345.                    screens which are interlaced. (Each pixel is only half
  346.                    as tall as it is wide.)
  347.  
  348.   Reverse       :  The font should be printed in the opposite direction
  349.                    (right to left).
  350.  
  351.   Design        :  If you have designed the font for the size specified in
  352.                    the "tf_ YSize" field this flag should be set. If a
  353.                    program has constructed this size of the font the flag
  354.                    should not be set. (The graphical quality of a
  355.                    Constructed font is usually not as good as a font which
  356.                    has been designed for this size.)
  357.  
  358.   Type          :  The fonts can either be 'Fixed Width' or 'Proportional'.
  359.  
  360.                                   - Page 5 -
  361. 9.    Font Information
  362.  
  363.                    Proportional fonts are ones where the width of each
  364.                    character will vary depending on how wide the character
  365.                    is itself. The box containing an "i" will (usually) not
  366.                    be as wide as a "w" for example.
  367.  
  368.   Users         :  Several programs may use the same font
  369.                    simultaneously, and this value represents the
  370.                    current number of users. Each time the font
  371.                    is opened by a program this value is increased,
  372.                    and each time someone closes the font this value
  373.                    is decreased. Although FontView is technically using
  374.                    the font, it won't show up in the number of users.
  375.  
  376.   Location      :  Tells us whether the Font is located on Disk or in Rom.
  377.  
  378. 10.    Development History
  379.  
  380.  
  381.  
  382.  History
  383.  
  384.     - Changes/Notes.
  385.     # Bugfix.
  386.     * New Feature.
  387.  
  388.  
  389.     v1.0    - Based on an Arexx program which I wrote a while ago.
  390.             - Now completely coded in C.
  391.             - First Public Release.
  392.  
  393.  
  394.     v1.01   * Added intuition menus.
  395.             # Bugfix: If the font requester had not been used and the
  396.                program was quit then a guru would occur. Simply because,
  397.                the program was trying to free a buffer for a non-existing
  398.                requester structure.
  399.  
  400.  
  401.     v1.02   - Minor changes to the GUI. Tidied up some of the string
  402.                gadget locations.
  403.             - Cleaned up intuition loops. All similar controls use the
  404.                same function instead of one for each.
  405.  
  406.  
  407.     v2.0    * Requires Kickstart v37+.
  408.             * Complete re-write. Now has font sensitive interface.
  409.             * Everything is now using proper gadtools.library calls.
  410.             - Font styles adjustable from main window.
  411.             * Added Change FONTS: dir option.
  412.             - Automatically senses the screen font in use and presents
  413.                data on it when the program begins.
  414.             - Font requester remembers last selected font.
  415.             - Various slight changes to displayed data.
  416.  
  417.  
  418.     v2.1    * Added Public Screen switching.
  419.             * Added Pull-Down menus.
  420.             # Bugfix: On some systems the requesters would refuse to
  421.                open on anything other than the Workbench Screen. This has
  422.                been fixed.
  423.             # Bugfix: Crashed on quiting if 'Use Screen' was selected
  424.                and nothing was entered. Disabled 'Use Screen' until
  425.                the listview has been used.
  426.             # Bugfix: Although FontView's initial data was the screen
  427.                font of the public screen on which it opened, the sample
  428.                displayer would only show topaz 8.
  429.             # Bugfix: If the Public Screen could not be located/used
  430.  
  431.                                   - Page 6 -
  432. 10.    Development History
  433.  
  434.                then the workbench was used but not brought to the front.
  435.             * Added a requester to notify if a screen could not be used.
  436.             - Slight change to 'About' requester - gadget text.
  437.  
  438.  
  439.     v2.2    # Bugfix: Some of the earlier bug fixes had created
  440.                problems of their own hopefully they are all gone.
  441.             - Re-worked the entire interface display.
  442.             - If no screen is selected from the requester, then the main
  443.                window will still close and refresh itself. This helps
  444.                avoid some of the updating problems it was having.
  445.             # Bugfix: A previous fix had stopped the font requester from
  446.                using the last selected font as a default - and if it was
  447.                canceled.
  448.  
  449.  
  450.     v2.3    * Added new font info items. Modulo, Baseline, BoldSmear,
  451.                TallDot, WideDot, RevPath, Designed.
  452.             * Redesigned interface from scratch to accommodate new
  453.                info items.
  454.             - Standardized some of the requester titles.
  455.             - Changed documentation to Amigaguide format.
  456.  
  457.  
  458.     v2.4    * Moved font information to a seperate window which can be
  459.                turned on or off. I found the info was only of interest on
  460.                occasions.
  461.             * The main window now has a zoom gadget which allows the
  462.                program to be iconified quite nicely. The menu functions
  463.                and hotkeys still work whilst the minimized window is
  464.                selected.
  465.             - Changed menu layout slightly.
  466.             # Bugfix: Previous version had to close and reopen the main
  467.                window if no screen was selected in the requester. This is
  468.                no longer necessary.
  469.  
  470.  
  471.     v2.5    * Added Fix Fonts function.
  472.             - Moved all gui info to one source file - less work.
  473.             - Stretched Font and Dir name gadgets - to allow for
  474.                longer names.
  475.             # Bugfix: The assign routine wasn't working perfectly.
  476.                changed to running the external Assign command. The
  477.                assign routine in earlier versions can cause some real
  478.                problems in a multi-tasking environment. Make sure the
  479.                assign command is in your c: directory.
  480.             - Made FontView shareware. Added appropriate requesters.
  481.             - Changed Menu Item 'About' to ? instead of A as per g/lines.
  482.             * All windows now have zoom gadgets to make them easier to
  483.                get out of the way if so required.
  484.  
  485.     v2.5a   - Added failure requesters for incorrect kickstart and
  486.                reqtools versions. Now when run on anything less than Wb2.0
  487.                the program will give a 'Requires Kickstart v37+' requester
  488.                instead of just quiting silently, and a 'Requires reqtools.
  489.                library v38+'.
  490.             - Slight changes to some requesters.
  491.             - There seems to be a problem with earlier releases of v38
  492.                reqtools and the font requester. I have been unable to
  493.                track this down, but using at least v38.1248 fixes
  494.                the problem.
  495.  
  496.     v2.5b   - Minor update due to my mail addresses changing.
  497.  
  498.     v2.5c   # Bugfix: FontView double-locked the workbench screen but
  499.                didn't release both locks when it quit. This resulted
  500.                in other programs being unable to close and re-open
  501.  
  502.                                   - Page 7 -
  503. 10.    Development History
  504.  
  505.                the workbench screen because intuition thought something
  506.                was still open there. :( Now fixed... :)
  507.  
  508.     v2.6    - Release date: 21 August 1995.
  509.             * Added Tooltype support.
  510.             - Re-wrote some of the documentation.
  511.             * Added PUBSCREEN tooltype - initial opening screen.
  512.             - Unregistered screen now opens after main window.
  513.             - Changed version string format.
  514.  
  515.     v2.7    - Release date: 01 May 1996.
  516.             - Minor changes to the gui.
  517.             * Registered Users display list added.
  518.             * FIXFONTS tooltype added.
  519.             * Expanded help for Cli arguments. Press ? at prompt.
  520.             - My Fidonet address and postal address changed.
  521.  
  522.     v2.8    - Release date: Internal version only.
  523.             - Major changes to Fontview guide, using Heddley.
  524.             - Slight change to registration - no special CPU versions.
  525.  
  526.     v3.0    - Release date: 16 Dec 1996
  527.             *   Complete re-write.
  528.             *   Interface redesigned from scratch.
  529.             *   Font sample now included in main window.
  530.             *   Font sample updates in real-time. You can change the font,
  531.                  and it's style and the display will automatically update.
  532.             -   Updated address details, including EMail.
  533.             -   Re-written guide file to reflect program changes.
  534.  
  535. 11.    Program Credits
  536.  
  537.  
  538.  
  539.  Credits
  540.  
  541. FontView v3.0 was created using the following software packages:
  542.  
  543.     SAS/C v6.3               © SAS Institute.
  544.     GadToolsBox v2.0c        © Jan Van Den Baard.
  545.     Reqtools.library v38     © Nico Francois.
  546.     Cygnus Ed v3.5           © CygnusSoft Software.
  547.     DirectoryOpus v5.5       © Jon Potter & GPSoftware
  548.     Heddley v1.1             © Edd Dumbill
  549.  
  550.  
  551. Thanks To:
  552.  
  553.   Jon Potter The font sample display was based in part on code from
  554.              Directory Opus 5.5 (c) 1996 Jonathan Potter & GPSoftware
  555.   Max Gunsberger for his requests/suggestions/bug reports.
  556.   Richard McElvenny for uploading the distribution to Aminet.
  557.  
  558. Registered Users:
  559.  
  560.       Max Gunsberger
  561.       Arthur Sawilejskij
  562.       Fred Mauloni
  563.       Nigel Schodel
  564.       Robert Rae Strickland
  565.       Klaus Becker Jnr
  566.       Petra Struck
  567.       Anthony Flanagan
  568.       Richard McElvenny
  569.       James Abram
  570.       JoAn K. Sells
  571.       Jon Potter
  572.  
  573.                                   - Page 8 -
  574. 11.    Program Credits
  575.  
  576.  
  577. 12.    Registration
  578.  
  579.  
  580.  
  581.  Registration
  582.  
  583.     As mentioned elsewhere in these documents, if you wish to continue using
  584. FontView then please consider registering.  Although, nothing is disabled in
  585. the unregistered release , a small donation would be greatly appreciated.  If
  586. only to get rid of the annoying requester...  :)
  587.  
  588.     If you wish to continue using FontView, then $AUD5 (Australian Dollars)
  589. is the suggested amount, although I will accept larger figures of course.
  590. :) Those that send the $5 will receive a personalised version of
  591. FontView, without the reminder requester's.
  592.  
  593.     Those that wish can also have FontView compiled to suit their CPU. By all
  594. accounts, using a version compiled for the faster machines does speed
  595. up program operation somewhat.  I am in no position to verify this, but I
  596. will send a 68000 version as well just in case any problems occur.
  597.  
  598.    NOTE:  I've given this some thought, and it just isn't worthwhile providing
  599. different versions of the program for various CPUs. If FontView was a
  600. rendering package then there would be some benefit to custom compiled code,
  601. but realistically, the program should perform it's job more than adequately
  602. with standard code.  Let me know if you really disagree.  :)
  603.  
  604.     Registered users can receive updates of FontView by simply sending
  605. a floppy disk and return postage.  I will send the most current version
  606. of FontView as soon as possible.  If I am working on a significant update
  607. I will retain the disk and send it when the update is finished.
  608.  
  609.     Send all relevant details to me along with your money.  I will not
  610. be responsible for chasing you if you don't tell me your address.  Be warned,
  611. I will pocket your money and leave it up to you to get in touch.
  612.  
  613.     For those with internet access, feel free to register via EMail, I will
  614. send your registered version back to your EMail address within a day or so.
  615. This is by far the quickest method.  Also the cheapest method for registered
  616. users to get updates (no disk or postage required).
  617.  
  618.     Thanks for trying FontView and I hope the program meets your needs...
  619.  
  620. 13.    Contacting The Author
  621.  
  622.  
  623.  
  624.  Author
  625.  
  626.     Send all bug reports, comments, registrations etc to:
  627.  
  628.             Steve Banham            Phone   : 61-65-849984
  629.             PO Box 964,             Fax     : 61-65-833255
  630.             Port Macquarie,
  631.             NSW, 2444               EMail   : sbanham@nor.com.au
  632.             Australia.
  633.  
  634.  
  635.  
  636.  
  637.  
  638.  
  639.  
  640.  
  641.  
  642.  
  643.  
  644.                                   - Page 9 -
  645. 13.    Contacting The Author
  646.  
  647.  
  648. 14.    INDEX of sections
  649.  
  650. Cli Usage ..........................................................   2. 28
  651. Contacting The Author ..............................................   8. 43
  652. Development History ................................................   5. 14
  653. Font Information ...................................................   4.  5
  654. FontView v3.0 ©1996 Steve Banham ...................................   1.  0
  655. Gadgets ............................................................   3. 28
  656. Installation .......................................................   2.  5
  657. Legal Information ..................................................   1. 17
  658. Program Credits ....................................................   7. 29
  659. Program Operation ..................................................   2. 66
  660. Registration .......................................................   8.  0
  661. What Is FontView? ..................................................   1. 47
  662. Workbench Usage ....................................................   2. 52
  663.  
  664. 15.    INDEX of keywords
  665.  
  666.    .................................................................   1.  7
  667.  CLI  ..............................................................   3.  7
  668.  Gadgets      ......................................................   3. 10
  669.  Information  ......................................................   3. 11
  670.  Workbench  ........................................................   3.  7
  671. author .............................................................   1. 31
  672. FIXFONTS ...........................................................   2. 27
  673. information ........................................................   3. 47
  674. registration .......................................................   1. 27
  675. registrations ......................................................   1. 37
  676. Steve Banham .......................................................   1. 25
  677.